/*
 *    Copyright (c) <2002-2006> <Jean-Philippe Barrette-LaPierre>
 *    
 *    Permission is hereby granted, free of charge, to any person obtaining
 *    a copy of this software and associated documentation files 
 *    (curlpp), to deal in the Software without restriction, 
 *    including without limitation the rights to use, copy, modify, merge,
 *    publish, distribute, sublicense, and/or sell copies of the Software,
 *    and to permit persons to whom the Software is furnished to do so, 
 *    subject to the following conditions:
 *    
 *    The above copyright notice and this permission notice shall be included
 *    in all copies or substantial portions of the Software.
 *    
 *    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
 *    OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 *    MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 
 *    IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY 
 *    CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 
 *    TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 *    SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */

#ifndef CURLPP_FORM_HPP
#define CURLPP_FORM_HPP

#include <curl/curl.h>
#include <list>
#include <string>

#include "dllfct.h"


namespace cURLpp
{
  class FormPart;
  
  /**
   * This class is used internally to wrap over curl_httppost
   * class.
   */
  class CURLPPAPI HttpPost
  {
  public:
    HttpPost();
    ~HttpPost();

    /**
     * initialize the HTTP post with the list of forms. The Forms 
     * will be cloned.
     */
    HttpPost &operator=(const std::list< cURLpp::FormPart * > &posts);

    
    /**
     * return the curl_httppost representation of this HTTP Post.
     * Be aware that the memory return is owned by the current 
     * instance, so don't try to delete it.
     */
    ::curl_httppost *cHttpPost() const;

    /**
     * Free all HTTP posts.
     */
    void clear();

  private:
    ::curl_httppost *mFirst;
    ::curl_httppost *mLast;
    std::list< cURLpp::FormPart *> mForms;
  };

  /**
   * This class is the base representation of a post. You need
   * to inherit from it to define a type of post.
   */
  class CURLPPAPI FormPart
  {
    friend class HttpPost;

  public:
    /**
     * initialize the FormPart. "name" is the name of the field.
     */
    FormPart(const char *name);

    /**
     * initialize the FormPart. "name" is the name of the field.
     */
    FormPart(const std::string &name);

    virtual ~FormPart();

    virtual FormPart *clone() = 0;

  protected:
    /**
     * it will add himself to the curl_httppost *first.
     */
    virtual void add(::curl_httppost **first, 
		     ::curl_httppost **last) = 0;

    /**
     * Contain the name of the field.
     */
    const std::string mName;
  };

  namespace FormParts {
    /**
     * This class is a file post. It will send a file in the
     * HTTP post.
     */
    class CURLPPAPI File : public FormPart
    {
    public:
      /**
       * initialize a File part. "name" is the name of the field. 
       * "filename" is the string that holds the filename.
       */
      File(const char *name, 
	   const char *filename);

      /**
       * initialize a File part. "name" is the name of the field. 
       * "filename" is the string that holds the filename. 
       * "contentType" is the MIME type of the file.
       */
      File(const char *name, 
	   const char *filename, 
	   const char *contentType);

      /**
       * initialize a File part. "name" is the name of the field. 
       * "filename" is the string that holds the filename.
       */
      File(const std::string &name, 
	   const std::string &filename);

      /**
       * initialize a File part. "name" is the name of the field. 
       * "filename" is the string that holds the filename. 
       * "contentType" is the MIME type of the file.
       */
      File(const std::string &name, 
	   const std::string &filename,
	   const std::string &contentType);

      virtual ~File();

      /**
       * This function will return a copy of the instance.
       */
      virtual File *clone();

    private:
      void add(::curl_httppost **first, 
	       ::curl_httppost **last);

    private:
      const std::string mFilename; 
      const std::string mContentType;
    };

    /**
     * This class is a file post. It will send a file in the
     * HTTP post.
     */
    class CURLPPAPI Content : public FormPart
    {
    public:
      /**
       * initialize a Content part. "name" is the name of the field. 
       * "content" is the string that holds the filename.
       */
      Content(const char *name, 
	      const char *content);

      /**
       * initialize a Content part. "name" is the name of the field. 
       * "content" is the string that holds the filename. 
       * "contentType" is the MIME type of the file.
       */
      Content(const char *name, 
	      const char *content, 
	      const char *contentType);

      /**
       * initialize a Content part. "name" is the name of the field. 
       * "content" is the string that holds the content.
       */
      Content(const std::string &name, 
	      const std::string &content);

      /**
       * initialize a Content part. "name" is the name of the field. 
       * "content" is the string that holds the content. 
       * "content_type" is the MIME type of the file.
       */
      Content(const std::string &name, 
	      const std::string &content,
	      const std::string &content_type);
    
      virtual ~Content();
    
      /**
       * This function will return a copy of the instance.
       */
      virtual Content *clone();

    private:
      void add(::curl_httppost **first, 
	       ::curl_httppost **last);

    private:
      const std::string mContent; 
      const std::string mContentType;
    };
  }
}

#endif //CURLPP_FORM_HPP
